package com.taskmanager.dao;

import com.taskmanager.entity.Category;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 分类数据访问层
 */
@Mapper
public interface CategoryDao {
    
    /**
     * 插入新分类
     * @param category 分类对象
     * @return 影响的行数
     */
    int insert(Category category);
    
    /**
     * 批量插入分类
     * @param categories 分类列表
     * @return 影响的行数
     */
    int batchInsert(@Param("categories") List<Category> categories);
    
    /**
     * 根据分类ID查询分类
     * @param categoryId 分类ID
     * @return 分类对象
     */
    Category selectById(@Param("categoryId") Long categoryId);
    
    /**
     * 根据用户ID查询所有分类
     * @param userId 用户ID
     * @return 分类列表
     */
    List<Category> selectByUserId(@Param("userId") Long userId);
    
    /**
     * 根据用户ID查询所有分类（包含任务数量统计）
     * @param userId 用户ID
     * @return 分类列表（含任务数量）
     */
    List<Category> selectByUserIdWithTaskCount(@Param("userId") Long userId);
    
    /**
     * 根据用户ID和分类名称查询分类
     * @param userId 用户ID
     * @param name 分类名称
     * @return 分类对象
     */
    Category selectByUserIdAndName(@Param("userId") Long userId, @Param("name") String name);
    
    /**
     * 查询用户的"其他"分类
     * @param userId 用户ID
     * @return 其他分类对象
     */
    Category selectOtherCategory(@Param("userId") Long userId);
    
    /**
     * 更新分类信息
     * @param category 分类对象
     * @return 影响的行数
     */
    int update(Category category);
    
    /**
     * 根据分类ID删除分类
     * @param categoryId 分类ID
     * @return 影响的行数
     */
    int deleteById(@Param("categoryId") Long categoryId);
    
    /**
     * 统计分类下的任务数量
     * @param categoryId 分类ID
     * @return 任务数量
     */
    int countTasksByCategoryId(@Param("categoryId") Long categoryId);
    
    /**
     * 检查分类是否属于指定用户
     * @param categoryId 分类ID
     * @param userId 用户ID
     * @return 是否属于该用户
     */
    boolean belongsToUser(@Param("categoryId") Long categoryId, @Param("userId") Long userId);
}
